home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / link.z / link
Encoding:
Text File  |  2002-10-03  |  7.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. lllliiiinnnnkkkk((((2222))))                                                                lllliiiinnnnkkkk((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      link, linkfollow - link to a file
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<uuuunnnniiiissssttttdddd....hhhh>>>>
  13.  
  14.      iiiinnnntttt lllliiiinnnnkkkk ((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ppppaaaatttthhhh1111,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ppppaaaatttthhhh2222))));;;;
  15.  
  16.      iiiinnnntttt lllliiiinnnnkkkkffffoooolllllllloooowwww ((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ppppaaaatttthhhh1111,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ppppaaaatttthhhh2222))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _p_a_t_h_1 points to a path name naming an existing file.  _p_a_t_h_2 points to a
  20.      path name naming the new directory entry to be created.  _llll_iiii_nnnn_kkkk creates a
  21.      new link (directory entry) for the existing file and increments its link
  22.      count by one.
  23.  
  24.      Upon successful completion, _llll_iiii_nnnn_kkkk marks for update the _ssss_tttt______cccc_tttt_iiii_mmmm_eeee field of
  25.      the file. Also, the _ssss_tttt______cccc_tttt_iiii_mmmm_eeee and _ssss_tttt______mmmm_tttt_iiii_mmmm_eeee fields of the directory that
  26.      contains the new entry are marked for update.
  27.  
  28.      _llll_iiii_nnnn_kkkk_ffff_oooo_llll_llll_oooo_wwww is identical to _llll_iiii_nnnn_kkkk unless _p_a_t_h_1 refers to a symbolic link.
  29.      If _p_a_t_h_1 is a symbolic link, _llll_iiii_nnnn_kkkk will make a link to the symbolic link;
  30.      _llll_iiii_nnnn_kkkk_ffff_oooo_llll_llll_oooo_wwww will make a link to the object that the symbolic link refers
  31.      to, and will fail if the symbolic link does not refer to any object.
  32.  
  33.      _llll_iiii_nnnn_kkkk will fail and no link will be created if one or more of the
  34.      following are true:
  35.  
  36.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Search permission is denied on a component of one of
  37.                          the path prefixes.
  38.  
  39.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Write permission is denied on the directory in which
  40.                          the link is to be created.
  41.  
  42.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Write permission is denied on the file named by
  43.                          _p_a_t_h_1.
  44.  
  45.      _EEEE_EEEE_XXXX_IIII_SSSS_TTTT              The link named by _p_a_t_h_2 exists.
  46.  
  47.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT              _p_a_t_h_1 or _p_a_t_h_2 points outside the allocated address
  48.                          space of the process.
  49.  
  50.      _EEEE_IIII_NNNN_TTTT_RRRR               A signal was caught during the _llll_iiii_nnnn_kkkk system call.
  51.  
  52.      _EEEE_LLLL_OOOO_OOOO_PPPP               Too many symbolic links were encountered in
  53.                          translating _p_a_t_h_1 or _p_a_t_h_2.
  54.  
  55.      _EEEE_MMMM_LLLL_IIII_NNNN_KKKK              The maximum number of links to a file would be
  56.                          exceeded.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. lllliiiinnnnkkkk((((2222))))                                                                lllliiiinnnnkkkk((((2222))))
  71.  
  72.  
  73.  
  74.      _EEEE_MMMM_UUUU_LLLL_TTTT_IIII_HHHH_OOOO_PPPP           Components of _p_a_t_h_1 or _p_a_t_h_2 require hopping to
  75.                          multiple remote machines and file system type does
  76.                          not allow it.
  77.  
  78.      _EEEE_TTTT_IIII_MMMM_EEEE_DDDD_OOOO_UUUU_TTTT           A component of _p_a_t_h_1 or _p_a_t_h_2 is located on a remote
  79.                          file system which is not available [see _iiii_nnnn_tttt_rrrr_oooo(2)].
  80.  
  81.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG        The length of the _p_a_t_h_1 or _p_a_t_h_2 argument exceeds
  82.                          {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX}, or the length of a _p_a_t_h_1 or _p_a_t_h_2
  83.                          component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX} while ______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is
  84.                          in effect.
  85.  
  86.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR             A component of either path prefix is not a directory.
  87.  
  88.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              _p_a_t_h_1 or _p_a_t_h_2 is a null path name.
  89.  
  90.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              A component of either path prefix does not exist.
  91.  
  92.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              The file named by _p_a_t_h_1 does not exist.
  93.  
  94.      _EEEE_NNNN_OOOO_LLLL_IIII_NNNN_KKKK             _p_a_t_h_1 or _p_a_t_h_2 points to a remote machine and the
  95.                          link to that machine is no longer active.
  96.  
  97.      _EEEE_NNNN_OOOO_SSSS_PPPP_CCCC              The directory that would contain the link cannot be
  98.                          extended.
  99.  
  100.      _EEEE_PPPP_EEEE_RRRR_MMMM               The file named by _p_a_t_h_1 is a directory.
  101.  
  102.      _EEEE_RRRR_OOOO_FFFF_SSSS               The requested link requires writing in a directory on
  103.                          a read-only file system.
  104.  
  105.      _EEEE_XXXX_DDDD_EEEE_VVVV               The link named by _p_a_t_h_2 and the file named by _p_a_t_h_1
  106.                          are on different logical devices (file systems).
  107.  
  108. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  109.      _ssss_yyyy_mmmm_llll_iiii_nnnn_kkkk(2), _uuuu_nnnn_llll_iiii_nnnn_kkkk(2), _rrrr_eeee_aaaa_llll_pppp_aaaa_tttt_hhhh(3).
  110.  
  111. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  112.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  113.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.